Marker Editing Using SCPI

This topic describes the SCPI commands used for editing markers in non-volatile memory.

Set Marker

Sets a single marker point or a range of marker points on a waveform segment for the selected marker (1–4).

There are three ways to place marker points using this command:

Consecutive marker points over a range that collectively create a single marker pulse that spans the range
Equally spaced marker points over a range, so that a marker pulse occurs at each sample point that coincides with a marker point (Using this method, you can configure a clock signal by setting the <skip_count> variable to one.)
A single marker point placed at a specific sample point in the waveform, which outputs a single pulse relative to the marker point location (To configure a single marker point, set the first and last points to the same number.)

The following list describes the command variables:

"<file_name">: Specifies the name of the waveform file.
<marker>: Selects the marker number; an integer value from one to four.
<first_point>: Defines the first point in the range over which the marker is placed. This number must be greater than or equal to one, and less than or equal to the total number of waveform points. If you enter a value for either the first marker point or the last marker point that would make the first marker point occur after the last, the last marker point is automatically adjusted to match the first marker point.
<last_point>: Defines the last point in the range over which the marker is placed. This value must be greater than or equal to the first point, and less than or equal to the total number of waveform points.
<skip_count>: Defines the marker point pattern across the range. A zero value means the marker points occur consecutively across the range. A value greater than zero creates a repeating marker point pattern across the range, where the gap between the marker points is equal to the <skip_count> value. The gaps begin after the first marker point. Each marker point in the pattern, which is only one point wide, produces a marker pulse. The maximum value is <last_point> - <first_point>.

SCPI Command	:MEMory:WAVeform:MARKer[:SET] "<file_name>",<marker>,<first_point>,<last_point>,<skip_count>
SCPI Example	MEM:WAV:MARK "NVWFM:MyWaveform",1,40,100,2 !This example sets marker 1 on the first point, 40, the last point, 100, and every third point (skip 2) between 40 and 100 (assuming the waveform file has at least 100 points).
Backwards Compatibility SCPI	[:SOURce]:RADio:ARB:MARKer[:SET]
Initial S/W Revision	A.03.00

Clear Marker

Clears a single marker point or a range of marker points on a waveform segment for the selected marker (1–4).

"<file_name>": Specifies the name of the waveform file.
<marker>: Selects the marker number; an integer value from one to four.
<first_point>: Defines the first point in the range over which the marker is placed. This number must be greater than or equal to one, and less than or equal to the total number of waveform points. If you enter a value for either the first marker point or the last marker point that would make the first marker point occur after the last, the last marker point is automatically adjusted to match the first marker point.
<last_point>: Defines the last point in the range over which the marker is placed. This value must be greater than or equal to the first point, and less than or equal to the total number of waveform points.

To clear a single marker point, use the same marker point for the first and last point variables.

SCPI Command	:MEMory:WAVeform:MARKer:CLEar "<file_name>",<marker>,<first_point>,<last_point>
SCPI Example	MEM:WAV:MARK:CLE "NVWFM:MyWaveform",1,1,300 !This example clears marker 1 from the first point through the 300th point in a waveform file MyWaveform.
Backwards Compatibility SCPI	[:SOURce]:RADio:ARB:MARKer:CLEar
Initial S/W Revision	A.03.00

Clear Marker All

Clears all marker points on a waveform segment for the selected marker (1–4).

"<file_name>": Specifies the name of the waveform file.
<marker>: Selects the marker number; an integer value from one to four.

SCPI Command	:MEMory:WAVeform:MARKer:CLEar:ALL "<file_name>",<marker>
SCPI Example	MEM:WAV:MARK:CLE:ALL "NVWFM:MyWaveform",1 !This example clears marker 1 from the all waveform points in a waveform file MyWaveform.
Backwards Compatibility SCPI	[:SOURce]:RADio:ARB:MARKer:CLEar:ALL
Initial S/W Revision	A.03.00

Rotate Marker

Shifts the marker points for all markers in a waveform segment earlier or later by the value of the <rotate_count> variable.

You can use a positive or negative value. When a marker point is close to the end of the waveform and the <rotate_count> value is greater than the number of remaining marker points, but less than the total number of marker points, the marker points that would move beyond the end of the waveform wrap to the beginning of the waveform. For example, if a marker point resides at sample point 195 out of 200, and the <rotate_count> value is twenty–five, the marker point wraps to the beginning of the waveform and continues out to the twentieth waveform point.

"<file_name>": Specifies the name of the waveform file.
<rotate_count>: Specifies the count by which the marker points are shifted; an integer value from -(n - 1) to (n - 1), where n is the total number of waveform points.

SCPI Command	:MEMory:WAVeform:MARKer:ROTate "<file_name>",<rotate_count>
SCPI Example	MEM:WAV:MARK:ROT "NVWFM:MyWaveform",100 !This example shifts all markers set in a waveform file MyWaveform 100 points later. If the first set point in the file is at 50, then after sending this command, the first set point will be 150 (assuming the waveform file has at least 150 points and no later set points wrapped around to the beginning of the file).
Backwards Compatibility SCPI	[:SOURce]:RADio:ARB:MARKer:ROTate
Initial S/W Revision	A.03.00